home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 41.zip / BS1 part 41 / Devpac 2.12 disk 2.adf / include.cbm / libraries / configregs.i next >
Text File  |  1987-03-31  |  7KB  |  206 lines
  1.  
  2. **** configregs.i *********************************************************
  3. *
  4. *  register and bit definitions for expansion boards
  5. *
  6. * Copyright (C) 1985,  Commodore-Amiga, Inc., All rights reserved.
  7. *
  8. * $Header: configregs.i,v 33.2 86/05/04 23:40:52 neil Exp $
  9. *
  10. * $Locker:  $
  11. *
  12. * $Log: configregs.i,v $
  13. * Revision 33.2  86/05/04  23:40:52  neil
  14. * added diag area
  15. * 
  16. * Revision 33.1  86/04/01  12:17:22  neil
  17. * First version
  18. * 
  19. *
  20. ****************************************************************************
  21.  
  22.         IFND    LIBRARIES_CONFIGREGS_I
  23. LIBRARIES_CONFIGREGS_I  SET     1
  24.  
  25. ** Expansion boards are actually organized such that only one nibble per
  26. ** word (16 bits) are valid information.  This table is structured
  27. ** as LOGICAL information.  This means that it never corresponds
  28. ** exactly with a physical implementation.
  29. **
  30. ** The expansion space is logically split into two regions:
  31. ** a rom portion and a control portion.  The rom portion is
  32. ** actually stored in one's complement form (except for the
  33. ** er_type field).
  34.  
  35.  
  36.  STRUCTURE ExpansionRom,0
  37.     UBYTE       er_Type
  38.     UBYTE       er_Product
  39.     UBYTE       er_Flags
  40.     UBYTE       er_Reserved03
  41.     UWORD       er_Manufacturer
  42.     ULONG       er_SerialNumber
  43.     UWORD       er_InitDiagVec
  44.     UBYTE       er_Reserved0c
  45.     UBYTE       er_Reserved0d
  46.     UBYTE       er_Reserved0e
  47.     UBYTE       er_Reserved0f
  48.     LABEL       ExpansionRom_SIZEOF
  49.  
  50.  STRUCTURE ExpansionControl,0
  51.     UBYTE       ec_Interrupt            ; interrupt control register
  52.     UBYTE       ec_Reserved11
  53.     UBYTE       ec_BaseAddress          ; set new config address
  54.     UBYTE       ec_Shutup               ; don't respond, pass config out
  55.     UBYTE       ec_Reserved14
  56.     UBYTE       ec_Reserved15
  57.     UBYTE       ec_Reserved16
  58.     UBYTE       ec_Reserved17
  59.     UBYTE       ec_Reserved18
  60.     UBYTE       ec_Reserved19
  61.     UBYTE       ec_Reserved1a
  62.     UBYTE       ec_Reserved1b
  63.     UBYTE       ec_Reserved1c
  64.     UBYTE       ec_Reserved1d
  65.     UBYTE       ec_Reserved1e
  66.     UBYTE       ec_Reserved1f
  67.     LABEL       ExpansionControl_SIZEOF
  68.  
  69. **
  70. ** many of the constants below consist of a triplet of equivalent
  71. ** definitions: xxMASK is a bit mask of those bits that matter.
  72. ** xxBIT is the starting bit number of the field.  xxSIZE is the
  73. ** number of bits that make up the definition.  This method is
  74. ** used when the field is larger than one bit.
  75. **
  76. ** If the field is only one bit wide then the xxB_xx and xxF_xx convention
  77. ** is used (xxB_xx is the bit number, and xxF_xx is mask of the bit).
  78. **
  79.  
  80. ** manifest constants */
  81. E_SLOTSIZE              EQU     $10000
  82. E_SLOTMASK              EQU     $ffff
  83. E_SLOTSHIFT             EQU     16
  84.  
  85. ** these define the two free regions of Zorro memory space.
  86. ** THESE MAY WELL CHANGE FOR FUTURE PRODUCTS!
  87. E_EXPANSIONBASE         EQU     $e80000
  88. E_EXPANSIONSIZE         EQU     $080000
  89. E_EXPANSIONSLOTS        EQU     8
  90.  
  91. E_MEMORYBASE            EQU     $200000
  92. E_MEMORYSIZE            EQU     $800000
  93. E_MEMORYSLOTS           EQU     128
  94.  
  95.  
  96.  
  97. ******* ec_Type definitions */
  98.  
  99. ** board type -- ignore "old style" boards */
  100. ERT_TYPEMASK            EQU     $c0
  101. ERT_TYPEBIT             EQU     6
  102. ERT_TYPESIZE            EQU     2
  103. ERT_NEWBOARD            EQU     $c0
  104.  
  105.  
  106. ** type field memory size */
  107. ERT_MEMMASK             EQU     $07
  108. ERT_MEMBIT              EQU     0
  109. ERT_MEMSIZE             EQU     3
  110.  
  111.  
  112. ** other bits defined in type field */
  113.         BITDEF  ERT,CHAINEDCONFIG,3
  114.         BITDEF  ERT,DIAGVALID,4
  115.         BITDEF  ERT,MEMLIST,5
  116.  
  117.  
  118. ** er_Flags byte -- for those things that didn't fit into the type byte */
  119.         BITDEF  ERF,MEMSPACE,7          ; wants to be in 8 meg space.  Also
  120.                                         ;     implies that board is moveable
  121.         BITDEF  ERF,NOSHUTUP,6          ; board can't be shut up.  Must not
  122.                                         ;     be a board.  Must be a box that
  123.                                         ;     does not pass on the bus.
  124.  
  125.  
  126. ** interrupt control register */
  127.         BITDEF  ECI,INTENA,1
  128.         BITDEF  ECI,RESET,3
  129.         BITDEF  ECI,INT2PEND,4
  130.         BITDEF  ECI,INT6PEND,5
  131.         BITDEF  ECI,INT7PEND,6
  132.         BITDEF  ECI,INTERRUPTING,7
  133.  
  134.  
  135. **************************************************************************
  136. **
  137. ** these are the specifications for the diagnostic area.  If the Diagnostic
  138. ** Address Valid bit is set in the Board Type byte (the first byte in
  139. ** expansion space) then the Diag Init vector contains a valid offset.
  140. **
  141. ** The Diag Init vector is actually a word offset from the base of the
  142. ** board.  The resulting address points to the base of the DiagArea
  143. ** structure.  The structure may be physically implemented either four,
  144. ** eight, or sixteen bits wide.  The code will be copied out into
  145. ** ram first before being called.
  146. **
  147. ** The da_Size field, and both code offsets (da_DiagPoint and da_BootPoint)
  148. ** are offsets from the diag area AFTER it has been copied into ram, and
  149. ** "de-nibbleized" (if needed).  Inotherwords, the size is the size of
  150. ** the actual information, not how much address space is required to
  151. ** store it.
  152. **
  153. ** All bits are encoded with uninverted logic (e.g. 5 volts on the bus
  154. ** is a logic one).
  155. **
  156. ** If your board is to make use of the boot facility then it must leave
  157. ** its config area available even after it has been configured.  Your
  158. ** boot vector will be called AFTER your board's final address has been
  159. ** set.
  160. **
  161. **************************************************************************
  162.  
  163.  STRUCTURE DiagArea,0
  164.     UBYTE       da_Config       ; see below for definitions
  165.     UBYTE       da_Flags        ; see below for definitions
  166.     UWORD       da_Size         ; the size (in bytes) of the total diag area
  167.     UWORD       da_DiagPoint    ; where to start for diagnostics, or zero
  168.     UWORD       da_BootPoint    ; where to start for booting
  169.     UWORD       da_Name         ; offset in diag area where a string
  170.                                 ;   identifier can be found (or zero if no
  171.                                 ;   identifier is present).
  172.  
  173.     UWORD       da_Reserved01   ; two words of reserved data.  must be zero.
  174.     UWORD       da_Reserved02
  175.     LABEL       DiagArea_SIZEOF
  176.  
  177. ; da_Config definitions
  178. DAC_BUSWIDTH    EQU     $C0     ; two bits for bus width
  179. DAC_NIBBLEWIDE  EQU     $00
  180. DAC_BYTEWIDE    EQU     $40
  181. DAC_WORDWIDE    EQU     $80
  182.  
  183. DAC_BOOTTIME    EQU     $30     ; two bits for when to boot
  184. DAC_NEVER       EQU     $00     ; obvious
  185. DAC_CONFIGTIME  EQU     $10     ; call da_BootPoint when first configing the
  186.                                 ;   the device
  187. DAC_BINDTIME    EQU     $20     ; run when binding drivers to boards
  188.  
  189. **
  190. ** These are the calling conventions for Diag or Boot area
  191. **
  192. ** A7 -- points to at least 2K of stack
  193. ** A6 -- ExecBase
  194. ** A5 -- ExpansionBase
  195. ** A3 -- your board's ConfigDev structure
  196. ** A2 -- Base of diag/init area that was copied
  197. ** A0 -- Base of your board
  198. **
  199. ** Your board should return a value in D0.  If this value is NULL, then
  200. ** the diag/init area that was copied in will be returned to the free
  201. ** memory pool.
  202. **
  203.  
  204.  
  205.         ENDC    !LIBRARIES_CONFIGREGS_I
  206.